home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / cvt2qb12.zip / CVT2QBBS.DOC < prev    next >
Text File  |  1993-05-29  |  9KB  |  190 lines
  1.  
  2.    ██████╗ ██╗   ██╗ ████████╗ ██████╗   ██████╗  ██████╗  ██████╗  ███████╗
  3.  ██╔════╝ ██║   ██║ ╚══██╔══╝ ╚════██╗ ██╔═══██╗ ██╔══██╗ ██╔══██╗ ██╔════╝
  4.  ██║      ██║   ██║    ██║     █████╔╝ ██║   ██║ ██████╔╝ ██████╔╝ ███████╗
  5.  ██║      ╚██╗ ██╔╝    ██║    ██╔═══╝  ██║▄▄ ██║ ██╔══██╗ ██╔══██╗ ╚════██║
  6.  ╚██████╗  ╚████╔╝     ██║    ███████╗ ╚██████╔╝ ██████╔╝ ██████╔╝ ███████║
  7.   ╚═════╝   ╚═══╝      ╚═╝    ╚══════╝  ╚══▀▀═╝  ╚═════╝  ╚═════╝  ╚══════╝
  8.  
  9.                ╒═════════════════════════════════════════════╕
  10.                │                                             │░░
  11.                │ T H E  T A G  TO  Q B B S  D A T A  F I L E │ ░
  12.                │                                             │ ░
  13.                │     C O N V E R S I O N  U T I L I T Y      │ ░
  14.                │                                             │ ░
  15.                ╘═════════════════════════════════════════════╛ ░
  16.                     ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  17.  
  18.  
  19.  
  20.  
  21.  
  22. Acknowledgements
  23. ~~~~~~~~~~~~~~~~
  24.     Thanks got to the TAG team for providing the structure information
  25.     necessary for utility authors to create the utilities that *we* all
  26.     ask for. Thanks especially to Victor Capton and Paul Williams, not only
  27.     for remaining the driving forces behind this special BBS system, but also
  28.     for giving insight  into  TAG's  inner  workings  making this and other
  29.     projects soooooooo much easier to handle.
  30.  
  31.     TAG is copyrighted By The T.A.G. Team
  32.     QuickBbbs (referred to as QBBS) is Copyrighted By Pegasus Software
  33.  
  34.     This program is  copyrighted  by  Rick  Cooper  and  remains  the  sole
  35.     property  of  same.  CVT2QBBS  is  NOT public domain, rather it's to be
  36.     considered freeware.
  37.  
  38. Guarantees/Warranties/And Other Fantasies
  39. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  40.     There is no warranty or guarantee offered with this program. The only
  41.     thing I will guarantee is it's ability to take up disk space.
  42.  
  43.     By using this program  you  agree  to  hold  harmless the author in all
  44.     regards and circumstance including but not limited to:
  45.  
  46.         Damage to drives
  47.         Damage to Date
  48.         Loss of income
  49.         Increased Sexual Awareness
  50.         Change of Gender or Species
  51.  
  52.  
  53. Purpose
  54. ~~~~~~~
  55.       Ain't  but  one  purpose  boys  and  girls and that is to allow TAG BBS
  56.     systems to interface easily and  quickly  with QBBS doors and utilities
  57.     that require real  information  rather  than  the  make  believe  stuff
  58.     generated   by   less,   application  specific,  more  generalized  Door
  59.     converters.
  60.  
  61.     CVT2QBBS will create the following Files:
  62.  
  63.         QUICKCFG.DAT    : Main QBBS Configuration File
  64.         MSGCFG  .DAT    : Message Base Configuration File
  65.         FILECFG .DAT    : File Base Configuration File
  66.         LIMITS  .CTL    : Daily Download K By S/L Restriction File
  67.         EVENTCFG.DAT    : Events Configuration File
  68.         USERS   .BBS    : QBBS Users List Data File
  69.         ALIAS   .BBS    : QBBS User Handle/Alias File
  70.         FILES   .BBS    : QBBS File Listing Files
  71.         FB??????.BBS    : QBBS CD-ROM File Listings Files.
  72.         FLSEARCH.CTL    : Old, Now extinct Files Area Listing (For AllFix)
  73.  
  74.     These files are written  true  to  QBBS  Version 2.76 standards and will
  75.     interface with virtually any door or utilities designed to operate with
  76.     QBBS  version  2.7?  (previous  QBBS  version  used  entirely  different
  77.     structures).
  78.  
  79. Command Line Switches
  80. ~~~~~~~~~~~~~~~~~~~~~
  81.     The calling syntax is as follows:
  82.  
  83.         CVT2QBBS (TAG System Dir) (TAG HMS Message base) [Options]
  84.  
  85.     Where :
  86.             TAG System Dir    := Path to TAG node's STATUS.DAT
  87.             TAG HMS Path    := Path To Hudson Message Base
  88.  
  89.             Options :=
  90.             NoCdRom         := Skips CD-ROMs When creating list files
  91.  
  92.             NOFILES         := Will Prevent  CVT2QBBS  from  Updating  List
  93.                                Files
  94.             V=              := Validation Key to use for new user validation
  95.                                This will allow you to use QBBS call back
  96.                                Verifiers (in conjunction with TAGUDATE)
  97.                                for user validation
  98.  
  99.     The  NOFILES  (case is not important) switch will prevent CVT2QBBS from
  100.     generating list files if  you  are  running multi-node with shared file
  101.     bases. The NOFILES switch should be used at least  once  so  your  list
  102.     file  system  is  maintained  but  is  redundant  if all file bases are
  103.     shared.
  104.  
  105.     The V= parameter (which can be swapped with the  NOFILES  option)  will
  106.     tell  CVT2QBBS which validation key to use for the call back validation
  107.     portion of the configuration file.  If  you do not specify a validation
  108.     key the CVT2QBBS will use the first validation record. Since TAGUDATE
  109.     will adjust the user AR flags and SL (and phone  number)  if  they  are
  110.     changed  in  a  door, you can now use a call back verifier designed for
  111.     use with QBBS. Two things to remember:  The DSL will be set to the same
  112.     level as SL (they are not seperated in QBBS) and the Special flags will
  113.     be set to what ever options the user has but will NOT be changed  other
  114.     wise  by  TAGUDATE...  Again there are no SPECIAL flags with QBBS. This
  115.     means if you use the mail  not  validated flag with non validated users
  116.     then it will remain after validation and you *will* have to  toggle  it
  117.     off manually.
  118.  
  119.     The NOCDROM skips CD-ROM drives when creating the QBBS list files. This
  120.     Switch should NOT be used the first time the program is run or after
  121.     you add a new  CD-ROM.  it's  intended  to  speed  up the processing by
  122.     skipping these areas once their list  files  have  been  generated  the
  123.     first time. (since they won't change again)
  124.  
  125. Setup
  126. ~~~~~
  127.     There isn't any per  say.  Just  place  CVT2QBBS in a directory that
  128.     is in your path... Make  sure  you  CALL the program from the directory
  129.     that you wish to use  as  this  particular  QBBS  node  directory  (the
  130.     program  will  write  the  data files to the CURRENT directory). If the
  131.     file SLK.DAT exist (by calling SETDLK  before CVT2QBBS) it will use the
  132.     information within to write the LIMITS.CTL file. (See the SETDLK.DOC
  133.     file for details).
  134.  
  135.  
  136. Operation
  137. ~~~~~~~~~
  138.     CVT2QBBS will maintain all  of  your  security  setups  in  regards  to
  139.     message  bases, file system, logon information, etc.. Both the security
  140.     level and FLAGS are maintained  in  all areas. This means that programs
  141.     that respect the QBBS security system will also respect  yours  without
  142.     modification.  It  will  also maintain all of your message base setups,
  143.     Network  AKAs,  Origin  lines,   private  areas,  ANSI  allowances  and
  144.     restrictions  as  well.  In case you are not familiar with QBBS, by the
  145.     way, USERS.BBS will be  written  in  your  HMS directory. This is means
  146.     that you will have a  different  USERS.BBS  for  each  separate  hudson
  147.     message  base  that  you  operate.  (multiple  nodes  with a single HMS
  148.     base will share the USERS.BBS user list)
  149.  
  150.     Used in conjunction with the rest of  the  utilities  included  in  this
  151.     archive  you  can  rest  assured that interfacing to your favorite QBBS
  152.     doors and maintenance program  will  be  smooth and efficient. Some of
  153.     the programs you will be able to run are:
  154.  
  155.         Blue Wave        : Proprietary Offline Mail Door
  156.         GrayQwk            : The best QWK Offline Mail Door for any BBS type
  157.         AcFiles            : The best file download/upload/maintenance system
  158.  
  159.     About the  only  TAG  specific  setup  that  CVT2QBBS  cannot handle is
  160.     multiple hudson message bases. If you want  to  use  the  program  with
  161.     messaging system such as GrayQwk you will have to setup a directory for
  162.     each  node and each message base you wish to access. This is cumbersome
  163.     but unless QBBS and it's related utility authors decided to embrace the
  164.     multiple hudson message base  idea  TAG  will  continue  to be the only
  165.     system using  this  concept.  To  expand  your  ability  to  use  these
  166.     utilities  and  programs, I would recommend using only a single message
  167.     base unless you have over 200 areas or 16mg of message base.
  168.  
  169.     If you plan to run several QBBS utilities or Doors  I  would  recommend
  170.     setting  up  a  permanent QBBS node directory for each of your TAG node
  171.     directories and simply point each  given door/utility to the proper QBBS
  172.     node directory... There is no need to maintain a separate  QBBS  system
  173.     for  each program. This will reduce the maintenance time and disk space
  174.     usage. This would also mean you  will not need other EXITINFO/QBBS data
  175.     file  creation  utilities  (such  as  DoorMaster)...  to   create   the
  176.     DorInfo?.Def,   ExitInfo,   and   UserOn   Drop  files  just  call  the
  177.     EXITINFO.EXE program  and  point  to  the  correct  QBBS  and  TAG node
  178.     directories. (See the EXITINFO.DOCs for details)
  179.  
  180.  
  181. If there is a problem
  182. ~~~~~~~~~~~~~~~~~~~~~
  183.  
  184.     I can be contacted via the TAGBETA, TAG, TAGDOORS echos or you can call
  185.     my BBS (Just For The Heck Of  It  II) at (219) 747-5971.. Or netmail me
  186.     at 1:236/16 @FidoNet
  187.  
  188.     Rick Cooper
  189.  
  190.